home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / DOS / CM / GIFSEE17.ZIP / GIFSEE.DOC < prev    next >
Encoding:
Text File  |  1994-05-20  |  15.6 KB  |  370 lines
  1.  
  2.               ▄▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄
  3.               █ ▄▄  █  █▄  █▄▄ █▄  █▄     Gif File Previewer
  4.               █▄▄█ ▄█▄ █   ▄▄█ █▄▄ █▄▄       Version 1.07
  5.  
  6.  
  7.        Copyrighted Pete Rocca & Multiboard Communications Center, 1994
  8.  
  9.  
  10. ╓───────────────────────────────────────────────────────────────────────────╖
  11. ║ GifSee 1.07                                                               ║
  12. ╙───────────────────────────────────────────────────────────────────────────╜
  13.  
  14.     A great utility that allows your users  to save  time by downloading
  15.     a collection of compressed GIF files instead of all the larger ones.
  16.  
  17.  
  18. ╓───────────────────────────────────────────────────────────────────────────╖
  19. ║ GifSee - What's new?                                                      ║
  20. ╙───────────────────────────────────────────────────────────────────────────╜
  21.  
  22.     ■ Support for multinode operation
  23.     ■ Creates unique working directories
  24.     ■ Support for local downloads
  25.     ■ Fixed a bug that caused data corruption if too many areas were defined
  26.     ■ Does an alphabetical sort of the file names
  27.     ■ Added a great utility that will silence the program
  28.     ■ Multiple configuration file support
  29.     ■ Better documentation
  30.     ■ Fixed stupid garbage display mistake with 1.04
  31.     ■ Fixed slow system display under OS/2 with SIO driver
  32.     ■ Allowed configurable GIFSEE.GIF in registered mode
  33.     ■ Allowed configurable help file
  34.  
  35. ╓───────────────────────────────────────────────────────────────────────────╖
  36. ║ GifSee - Configuration                                                    ║
  37. ╙───────────────────────────────────────────────────────────────────────────╜
  38.  
  39.     ■ GifSee is very easy to install.
  40.     ■ The configuration file format is displayed below...
  41.  
  42.         Line 1 : BBS Name
  43.         Line 2 : Sysop Name
  44.         Line 3 : Registration Number
  45.         Line 4 : Path/Name of DSZ program (Example C:\UTIL\DSZ.EXE)
  46.         Line 5+: @File area description|file area path
  47.                  (Example @General Graphics|c:\files\gifs)
  48.  
  49.           (It's easier to look at the config file to catch on to this)
  50.  
  51.  
  52.     A couple of quick notes:
  53.  
  54.        1) This program can be run without any graphics being displayed
  55.           locally by setting an enviroment variable "SET GIFDESK=FILE"
  56.           in your batch file just before running GifSee.
  57.  
  58.           Example:
  59.                        @echo off
  60.                        cd \util\gifsee
  61.                        set GIFDESK=FILE
  62.                        GIFSEE \ra\door.sys
  63.  
  64.           I highly suggest the GIFDESK=FILE command, but remember you
  65.           should run a disk cache program if you are not already.
  66.  
  67.        2) This program WILL accept the DSZPORT redirection enviroment
  68.           variable. (see DSZ documentation for more information)
  69.  
  70.           Example:
  71.                        @echo off
  72.                        set gifdesk=file
  73.                        cd \ra\doors\gifsee
  74.                        if (%1) == (1) set DSZPORT=4
  75.                        if (%1) == (2) set DSZPORT=02f8,5
  76.                        if (%1) == (3) set DSZPORT=
  77.                        gifsee \ra\node%1\door.sys
  78.  
  79.           And I pass the node number to this batch file as it's only
  80.           parameter:  \ra\doors\GIFSEE.BAT <nodenumber>
  81.  
  82.  
  83.        3) The file GIFSEE.GIF _must_ be in the current directory along
  84.           will GifSee and GifDesk. (in unregistered mode)
  85.  
  86.        4) You can change the help file the GifSee displays by creating
  87.           a text file called GIFSEE.HLP in the same directory as the
  88.           GIFSEE.EXE file.
  89.  
  90.  
  91. ╓───────────────────────────────────────────────────────────────────────────╖
  92. ║ GifSee - Running                                                          ║
  93. ╙───────────────────────────────────────────────────────────────────────────╜
  94.  
  95.  
  96.     -TWO- options...
  97.  
  98.     1) The GifSee  program must be run in the same directory as GIFSEE.CFG
  99.        and GIFDESK.EXE and must be called with one parameter, which is the
  100.        drop file.
  101.  
  102.        Example  ══  \gifsee\GIFSEE.EXE \bbs\DORINFO1.DEF
  103.  
  104.     2) The GifSee program must be run in the same directory as GIFDESK.EXE
  105.        and must  be called with  two parameters, the  first being the drop
  106.        file and the second  being the path\name of the configuration file.
  107.        This allows you to define multiple configurations depending on your
  108.        security setups, etc.
  109.  
  110.        Example  ══  \gifsee\GIFSEE.EXE \bbs\DOOR.SYS \gifsee\ADULT.CFG
  111.  
  112.        (With this way, you can have multiple menu entries that can be
  113.         accessed by users with certain age/security settings)
  114.  
  115.     Valid drop file formats are  EXITINFO.BBS (type 2+ only),  DOOR.SYS,
  116.     DORINFO?.DEF.
  117.  
  118.     (altough, if running TriBBS, stick with the "DORINFO1.DEF", as reports
  119.     say that DOOR.SYS may cause a problem, generating a Runtime Error 106)
  120.  
  121.  
  122. ╓───────────────────────────────────────────────────────────────────────────╖
  123. ║ GifSee - Common questions                                                 ║
  124. ╙───────────────────────────────────────────────────────────────────────────╜
  125.  
  126.     Q) How do I stop the graphics from displaying on my montior?
  127.     A) Use the GIFDESK=FILE setting before running GIFSEE
  128.  
  129.     Q) It makes the picture, but it looks all garbaled!
  130.     A) Use the GIFDESK=FILE setting before running GIFSEE, as your
  131.        monitor does not support 640x480x256 color mode.
  132.  
  133.     Q) The pictures it makes are small, but is there anyway to make
  134.        them even smaller?
  135.     A) Try using the GIFDESK=VGA mode if you don't mind the graphics
  136.        being displayed locally.  It will make a 640x480x16 color file
  137.        which is pretty small usually.  Refer to the GIFDESK.DOC file
  138.        for other modes you might want to try.
  139.  
  140.     Q) How much hard drive space does this take when running?
  141.     A) Well, due to what it's doing, sometimes quite a bit.  It copies
  142.        each file to a temporary directory, and then creates the new
  143.        file. This alone could be some amount if the user combines 8
  144.        300k files (2.4megs), the swapping routine may also need to use
  145.        hard disk space if not enough XMS or EMS is available (upto 450k
  146.        more) and if you are using the GIFDESK=FILE setting, another 768k
  147.        gets eaten up, so the maximum it might require is about 4 megs,
  148.        remember that this is temporary, and as soon as the user has
  149.        completed their download, it will be released.  With normal
  150.        circumstances, the usual amount of temporary space is around 1-2
  151.        megs.
  152.  
  153.     Q) I have less than 12,000 files, but not all of them are being
  154.        displayed.
  155.     A) Either you haven't registered it :) or you have run out of memory.
  156.        Check the lower right hand corner. If it is less than 10k or just
  157.        a blank spot. You should increase the amount of memory you give
  158.        GifSee to run in.
  159.  
  160.     Q) Can I change the help file that GifSee displays?
  161.     A) Yes, make your own text file called GIFSEE.HLP and it will be
  162.        displayed instead of the original hardcoded one.
  163.  
  164.     Q) How much memory does GifSee need?
  165.     A) It really is dependant on how many files you have. If you have a
  166.        small GIF file collection, probably around 220k will be enough.
  167.        However, if you have 12,000 files, you will probably need about
  168.        300k to run successfully. If you experience problems, try to
  169.        increase the memory.  Personally, on my system, I run with about
  170.        400k free in the window.
  171.  
  172.     Q) Why copy them to a temporary drive?
  173.     A) Because it takes about 10 times longer to read them from other
  174.        directories, expecially CDROM drives.
  175.  
  176.     Q) Does it respect my BBS's security levels for file areas?
  177.     A) No, I want it to be flexible and able to be used with any BBS
  178.        system.  It is up to you to make menu options that pass an
  179.        appropriate configuration file to GifSee.
  180.  
  181.     Q) How do I restrict certain users from certain areas?
  182.     A) You will have to make multiple configuration files that
  183.        will configure the correct file areas for each security
  184.        level.  For example, if you have two types of users, say
  185.        Minor and Adult, then you could have two config files, and
  186.        in your menu options, you would make two options, the first
  187.        would be available to the adult user, and the second to the
  188.        minor user.  The menu would call GifSee and pass it an
  189.        appropriate configuration file.
  190.  
  191.     Q) What if I have more than 25 areas?
  192.     A) Bascially use the same method as above, except instead of
  193.        user security levels, you might have it divided into
  194.        library configuration files.  GifSee is very flexible in
  195.        the way it's design is implemented.
  196.  
  197.     Q) Will GifSee in the future support BBS package security levels?
  198.     A) Not likely, due to the fact that there are toooo many
  199.        different packages.
  200.  
  201.     Q) Will GifSee in the future support more that 25 areas?
  202.     A) Most likely.  I am still working on a way to increase the
  203.        memory capabilities even more, and you may see this increase
  204.        in future versions.
  205.  
  206.     Q) How do I stop that damn beeping sound?
  207.     A) Run the NOBEEP program once, that will stop it forever.
  208.        To return sound, simply rename the .OLD file back to an .EXE
  209.  
  210.     Q) Does this work with multinode?
  211.     A) Yes.
  212.  
  213.     Q) Can I change the GIFSEE.GIF file?
  214.     A) When you register, you can replace the GIFSEE.GIF picture with
  215.        any GIF of your own.  (For example, a BBS Advertisment, or
  216.        whatever else you wish)
  217.  
  218.     Q) Is this program only $7.00 for real?
  219.     A) Yes, so please register, hey it's real cheap!
  220.  
  221.  
  222. ╓───────────────────────────────────────────────────────────────────────────╖
  223. ║ GifSee - Common error codes                                               ║
  224. ╙───────────────────────────────────────────────────────────────────────────╜
  225.  
  226.            1-1: Not enough memory to swap
  227.   4-0 to 6-255: Error swapping
  228.  
  229.            2-0: File not found
  230.     2-1 to 2-4: Bad path
  231.            2-5: Path too long
  232.            2-6: Drive not ready
  233.  
  234.            3-2: File not found
  235.            3-3: Path not found
  236.            3-5: Access denied
  237.           3-10: Out of memory
  238.  
  239.      If you cannot resolve an error, then please forward the error code
  240.      as well as a description of what it was doing at the time of error
  241.      and a copy of your CFG, recent LOG and BAT file to my Fido address
  242.      1:2401/123 or call me data at (519)660-8981  [1200-14400]
  243.  
  244.  
  245. ╓───────────────────────────────────────────────────────────────────────────╖
  246. ║ License and Disclaimer                                                    ║
  247. ╙───────────────────────────────────────────────────────────────────────────╜
  248.  
  249.     GifSee is not free,   it is being marketed under the "try before you
  250.     buy" or  shareware concept.  You are  entitled to  use GifSee  for a
  251.     period up to thirty (30) days, after which you MUST register it.
  252.  
  253.     Registration entitles you to use  this version of  GifSee as well as
  254.     any future versions of the programs that may or may not be released.
  255.  
  256.     By running any of the  executable programs included,  you agree that
  257.     Pete Rocca,  nor any affiliates  of Pete Rocca  are  responsible for
  258.     any damage ever experienced, however so created. If you cannot agree
  259.     to this, then your privilege to use any of these programs is revoked
  260.     and it becomes illegal for you to execute any programs included with
  261.     this documentation.
  262.  
  263.     You may freely copy and  distribute the  shareware version of GifSee
  264.     as long as its original archived  contents  are not  modified in any
  265.     way.  You  may not use nor distribute a registration key without the
  266.     written consent of Pete Rocca of Multiboard Communications Centre.
  267.  
  268.     It is illegal to hack, reverse engineer and/or modify any components
  269.     of the GifSee archive.  If you  agree to all  of the above, then you
  270.     may use this program.
  271.  
  272.  
  273. ╓───────────────────────────────────────────────────────────────────────────╖
  274. ║ Registration                                                              ║
  275. ╙───────────────────────────────────────────────────────────────────────────╜
  276.  
  277.  
  278.     Canada:  If registering in Canada then please send $7 (CDN funds) via
  279.              cheque or money order payable to "Multiboard Communications"
  280.              to 150 Mill Street, London, Ontario, Canada, N6A1P6
  281.  
  282.     Outside
  283.     Canada:  If registering outside of Canada then please send $7 (US
  284.              funds) via US check or US money order payable to "Multiboard
  285.              Communications" to 150 Mill Street, London, Ontario, Canada,
  286.              N6A1P6
  287.  
  288.  
  289.  
  290.                            GIFSEE REGISTRATION 1.07
  291.                            ~~~~~~~~~~~~~~~~~~~~~~~~
  292.  
  293.  
  294.        Name: _____________________________________________________
  295.  
  296.     Address: _____________________________________________________
  297.  
  298.              _____________________________________________________
  299.  
  300.        City: ________________________  Province/State: ___________
  301.  
  302.  
  303.     Country: ________________________  Postal/Zipcode: ___________
  304.  
  305.  
  306.    BBS Name: _____________________________________________________
  307.  
  308.   BBS Phone: ________________,  ________________,  _______________
  309.  
  310.    Software: _____________________________________________________
  311.  
  312.     FidoNet: ___________________ (if applicable)
  313.  
  314.  
  315.                Operating System Info, and any other information
  316.  
  317.              _____________________________________________________
  318.  
  319.              _____________________________________________________
  320.  
  321.  
  322.  
  323.              Send my registration key: Via Snail mail         [  ]
  324.                                        To my FidoNet Node     [  ]
  325.  
  326.  
  327.  
  328.          _____ / _____ / _____  (   )
  329.  
  330.          +-----+                                             +-----+
  331.          |     |         Please leave boxes unmarked         |     |
  332.          +-----+                                             +-----+
  333.  
  334.  
  335.  
  336. ╓───────────────────────────────────────────────────────────────────────────╖
  337. ║ Support, Comments                                                         ║
  338. ╙───────────────────────────────────────────────────────────────────────────╜
  339.  
  340.     If you have any questions or comments,  you  can  Netmail me  at the
  341.     FidoNet (1:2401/123) XA,CM,V32,V42.  Registered users will get their
  342.     replies sent out direct, however,unregistered users will either have
  343.     to poll my system for responses, or request I route the message back
  344.     to you. (Sorry, but I have to keep costs down)  You can also find me
  345.     in the RemoteAccess Utilities FidoNet area.   The latest version can
  346.     always be FREQ'd with the magic name "GIFSEE".
  347.  
  348.  
  349. ╓───────────────────────────────────────────────────────────────────────────╖
  350. ║ Acknowledgments                                                           ║
  351. ╙───────────────────────────────────────────────────────────────────────────╜
  352.  
  353.     This program  is tested on Dos 3.3 upto Dos 6.2, DesqView 2.40  thru
  354.     2.62, DV/X 1.2 thru 2.0, Windows 3.1, WinOS/2 and OS/2 2.0 thru 2.11
  355.     Other enviroments should be fine, but they have not been tested yet.
  356.  
  357.     GifDesk(tm) is  a copyrighted piece of freeware,  being  distributed
  358.     with GifSee as legally stipulated in the GifDesk documentation.  GIF
  359.     is a registered trademark of CompuServe.
  360.  
  361.     Thanks to my wife Laurie, who hates me being on 'this damn machine',
  362.     but still finds the way to support me.  Thank you.
  363.  
  364.     Thanks to you,  the user,  for actually reading to  the  end of the
  365.     documentation, congratulations, and remember, please register.
  366.  
  367.                                     ---
  368.  
  369.                     Documentation End / April 29th, 1994
  370.